home *** CD-ROM | disk | FTP | other *** search
/ Cobra Utilities for Doom & Doom II / Cobra Utilities For Doom & Doom II - Disc 2.iso / files / program / die024 / die.doc < prev    next >
Encoding:
Text File  |  1994-04-07  |  8.8 KB  |  213 lines
  1. /*********************** Doom Image Editor v2.4 ****************************/
  2. -Disclaimer:
  3.      By reading this file DIE.DOC and/or installing it, you hereby 
  4.      acknowledge you the reader are wholly responsible in every way 
  5.      shape or form for any effects the user (you) incur.  I have made
  6.      every reasonable effort to insure DIE executes correctly.
  7.  
  8. -DIE is FREEWARE.  
  9.      Use it, distribute it, upload it,
  10.      but don't exploit it.  Don't act like it's yours and make others
  11.      pay a fee (dollars) for you giving it to them.  That is not cool.
  12.      I released this as FREEWARE, and it shall stay that way.  If you 
  13.      think you need to have someone pay for you to sit on your butt
  14.      and copy it to diskette...that's bull.  However, if you need to milk
  15.      .50 cents out of 'em for a diskette, I suppose that makes sense.
  16.  
  17. -Updates for DIE v1.1:
  18.      - added mouse speed settings to die.cfg.
  19.      - added check for mouse on startup.
  20.      - added visual for image load\save status.
  21.      - the executable is now named DIE.EXE (no more version numbers to type).
  22.  
  23. -Updates for DIE v1.2:
  24.      - increased size of static image memory 
  25.      - added a more solid check for non compatible image format: 
  26.           You may notice some of the images you edited before, you may
  27.           not be able to edit now.  This is because some of the images
  28.           were not recognized as incompatible with DIE's current abilities.
  29.      - added a more solid pixel read/write algorithm 
  30.      - including a front end for DIE in the DIE package
  31.      - !!!! bitchin !!!!!!
  32.           You can use the -file param with doom to load .DIE files.
  33.           If you are afraid of fraggin-up your .WAD file, use the 
  34.           -file param when you run doom so you can test the new creation
  35.           out first before making the import with WT.
  36.  
  37.                     DOOM -file sky1.die
  38.  
  39. -Updates SINCE DIE v1.2:
  40.      -updated the file type detection so it wouldn't choke and puke.
  41.      -added animated image editing (!! MONSTERS !!).
  42.      -added fast fill feature for f2 key.
  43.      -added check for mouse with diefe which tells die.
  44.           if mouse has already been checked.
  45.      -fixed bug dealing with file size.
  46.      -coded front end DIEFE.
  47.      -fixed bug for end of file detection.
  48.      -added zoom window for f3 key.
  49.      -switched back to malloc().
  50.      -worked on malloc bugs.
  51.      -increased size of zoom window.
  52.      -updated check for file type.
  53.      -worked on malloc() bugs.
  54.      -moved zoom window position and current color position.
  55.      -added free() function when reading pixels and run out of memory.
  56.      -added reload() for f4 key.
  57.      -fixed bug in file write index (bytes supposedly not used).
  58.      -took out file overwrite prompt for shareware users.
  59.      -added more robust wadcheck on initialization/visual.
  60.  
  61.  
  62. -What it is:
  63.      DIE (Doom Image Editor) is a utility for the seemingly endless 
  64.      tools for the DOOM wad.  
  65.      (The game DOOM ain't gonna die out for a looonnggg time.)
  66.  
  67.      You can Export an Image from WADTOOLS (c) Jeff Miller 1994, and
  68.      Import it to DIE.  Then you can paint all over it, Import it back
  69.      to WADTOOLS, and Shazam.  Custom walls.  You can also use the -file
  70.      param (as mentioned above) to test out the new image.
  71.  
  72.      !!! DO NOT EXPORT THE IMAGE TO A .LBM FILE. !! 
  73.      DIE only works with raw DOOM.WAD data.
  74.  
  75.      If you have the Shareware Version <sigh> (still..). Register DOOM.
  76.      DIE will not work with the Shareware version in keeping with
  77.      ID software's request to limit hacks to the registered version.
  78.  
  79.      At this point, DIE is a point and grunt paint program.  You are
  80.      limited to pixel by pixel painting.  If you wanna gripe, go ahead.  
  81.      Be glad all these DOOM hackers are keeping you griper leeches 
  82.      satisfied !
  83.  
  84. -How to use it:
  85.      (where this file notes < > for explaining configuration info, do not 
  86.       include the "< >".  They are used only for illustration.)
  87.  
  88.      There should be five files in the DIE012.ZIP package:
  89.           DIEFE .EXE - Front end to make typing less of a hassle.
  90.           DIEFE .DOC - Doc for Die's Front End.
  91.           DIE   .EXE - Doom Image Editor.
  92.           DIE   .DOC - What you is reading.
  93.           DIE   .DAC - Image of the DAC registers.
  94.           DIE   .CFG - DIE'S configuration file.
  95.  
  96.      Bark up your favorite text editor, and change (in DIE.CFG) the line:
  97.  
  98.           doomdir <path_to_wadfile\wadname>
  99.  
  100.      to be set to the path of your DOOM.WAD file with the name of your
  101.      main DOOM.WAD tacked to the end.  (doomdir c:\doom\doom.wad).
  102.      
  103.      I did this so you can have a separate directory for DIE, other than
  104.      your DOOM directory.  (Mine is soooooooo full of stuff.....).
  105.  
  106.      Also, set the desired mouse speed at the line:
  107.  
  108.           mouse <x_speed> <y_speed> <sensitivity>
  109.  
  110.                - x, y, and sensitivity can range from 1 to 100.
  111.  
  112.      go into WADTOOLS (c) Jeff Miller 1994, and find your image to EXPORT.
  113.      give it an extension too, if you want.
  114.  
  115.      Execute DIE like this:   DIE <Image_exported>
  116.  
  117.      If I exported SKY1.DOM from WADTOOLS, (I export mine with extensions), 
  118.      I would type
  119.  
  120.           DIE SKY1.DOM
  121.  
  122.      You will then see a checking of the mouse driver, and a status of
  123.      the image loading.  (or an error message if you made a mistake).
  124.  
  125.      If the file you are loading already exists in the current directory
  126.      with the extension of .DIE, you will be asked if you want to 
  127.      continue; this means the file will be overwritten if you save it
  128.      at the end.
  129.  
  130.      You should then have the image on the screen, a "color bar", and the
  131.      mouse cursor (yes, I KNOW it's ugly in mode 13h, but it turns off
  132.      when you are drawing).
  133.  
  134.      When you grunt on a color with the right mouse button, a small box
  135.      will appear in the lower left corner of the screen in the color
  136.      you chose.  This is the current drawing color.  You may also choose
  137.      a color from the image. 
  138.  
  139.      Use the left mouse button to color a pixel, and the F1 key will
  140.      redraw the screen (if you get sloppy).
  141.  
  142.      If you decide you want to recolor the whole image to the current 
  143.      color selected, hit F2.
  144.  
  145.      To zoom in on a section of the image, position the mouse and hit
  146.      F3.  This will zoom in, from the mouse position, to the right and down.
  147.      You can also jig around in the zoom window with the arrow keys.  
  148.      *it will not (should not) move past the bounds of the image.
  149.      
  150.           There is a seeming "bug" in the zoom window.  It will sometimes
  151.           paint pixels outside of the image. This is only aesthetic. Hit F1,
  152.           and the real image (stored in the array) will be redrawn.  
  153.           I'll fix this when I figure out how. 
  154.                (I'm beginning to appreciate Windows PAINT).
  155.          
  156.      If you screw up, you can reload the image from within the DIE "IDE",
  157.      (Integrated Doom Environment), with the F4 key.  All your changes
  158.      will be lost. 
  159.  
  160.      When you hit escape, you will be prompted to save the image.  This
  161.      is done regardless.  Even if you didn't change the image.
  162.  
  163.      You will then have a file in the current directory with the .DIE
  164.      extension. This is the file to import back into WADTOOLS.
  165.  
  166.      Enemy image editing is now available!
  167.           You are, however, limited to the pixels occupied by the image.
  168.           You can't just draw a bunch of S___ on the screen and call it
  169.           an IMP.  You can only draw on the pixels that are there.
  170.  
  171. -Wuz next:
  172.      I really need to change some things to use the tweaked modes of
  173.      320x200.  Mode 13h sucks, but the mouse cursor doesn't recognize
  174.      the tweaked modes.  I could 'emulate' a cursor, but haven't played
  175.      with it yet.  This is probably next.  
  176.      (Homework still not done; anybody got some Windows code for sale ?....)
  177.  
  178.           
  179.  
  180. /************************* Thanks go to: ************************************/ 
  181.  
  182. Jeff Miller 
  183.      -WADTOOLS.
  184.      THANKS!
  185.      Nice program Jeff. Without your exporting, DIE
  186.      would by dead. <pun, grin, grin>
  187.  
  188. Raphael Quinet quinet@montefiore.ulg.ac.be 
  189.      -NEWDEU  
  190.      THANKS!
  191.      I see you have the home-grown maps nailed.  *bitchin*.
  192.  
  193. Brendon Wyber (b.wyber@csc.canterbury.ac.nz).
  194.      -DEU
  195.      THANKS!
  196.      Are you and this Raphael dude doin this DEU thing as a team effort ?
  197.      
  198. Matt Fell (matt.burnett@acebbs.com)
  199. Hank Leukart (ap641@cleveland.freenet.edu)
  200.      -DMSPECS...
  201.      THANKS!
  202.      Without your specs, I would have given up on the pixel format a long
  203.      time ago.  These were a real HELP.
  204.  
  205. AND thanks go to any one else contributing to the Great Doom Hack, 
  206. may your BFG never go limp.
  207.  
  208. ****************************************************************************/
  209.  
  210.                                                  
  211.  
  212.  
  213.